home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / cat3 / GetVRoot.3 < prev    next >
Text File  |  1994-09-20  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. Tk_GetVRootGeometry(3)Tk Library Procedures
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      Tk_GetVRootGeometry - Get location and size of virtual  root
  12.      for window
  13.  
  14. SYNOPSIS
  15.      #include <tk.h>
  16.  
  17.      Tk_GetVRootGeometry(_t_k_w_i_n, _x_P_t_r, _y_P_t_r, _w_i_d_t_h_P_t_r, _h_e_i_g_h_t_P_t_r)
  18.  
  19. ARGUMENTS
  20.      Tk_Window   _t_k_w_i_n       (in)      Token  for  window   whose
  21.                                        virtual   root  is  to  be
  22.                                        queried.
  23.  
  24.      int         _x_P_t_r        (out)     Points to word in which to
  25.                                        store  x-offset of virtual
  26.                                        root.
  27.  
  28.      int         _y_P_t_r        (out)     Points to word in which to
  29.                                        store  y-offset of virtual
  30.                                        root.
  31.  
  32.      unsigned int            _w_i_d_t_h_P_t_r(out)
  33.                                        Points to word in which to
  34.                                        store   width  of  virtual
  35.                                        root.
  36.  
  37.      unsigned int            _h_e_i_g_h_t_P_t_r(out)
  38.                                        Points to word in which to
  39.                                        store  height  of  virtual
  40.                                        root.
  41. _________________________________________________________________
  42.  
  43.  
  44. DESCRIPTION
  45.      TkGetVRootGeometry returns geometry  information  about  the
  46.      virtual  root  window  associated with _t_k_w_i_n.  The ``associ-
  47.      ated'' virtual root is the  one  in  which  _t_k_w_i_n's  nearest
  48.      top-level  ancestor  (or  _t_k_w_i_n  itself if it is a top-level
  49.      window) has been reparented by  the  window  manager.   This
  50.      window  is  identified by a __SWM_ROOT or __WM_ROOT property
  51.      placed on the top-level window by the  window  manager.   If
  52.      _t_k_w_i_n  is  not associated with a virtual root (e.g.  because
  53.      the window manager doesn't use virtual roots) then *_x_P_t_r and
  54.      *_y_P_t_r  will be set to 0 and *_w_i_d_t_h_P_t_r and *_h_e_i_g_h_t_P_t_r will be
  55.      set to the dimensions of the screen containing _t_k_w_i_n.
  56.  
  57.  
  58. KEYWORDS
  59.      geometry, height,  location,  virtual  root,  width,  window
  60.  
  61.  
  62.  
  63. Tk                                                              1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. Tk_GetVRootGeometry(3)Tk Library Procedures
  71.  
  72.  
  73.  
  74.      manager
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Tk                                                              2
  130.  
  131.  
  132.  
  133.